Uim Service API function prototypes. More...

Data Structures
struct	UIMPowerDownReq

struct	fileInfo

struct	UIMRefreshEvent

struct	appStatus

struct	slotInfo

struct	cardStatus

struct	hotSwapStatus

struct	validCardStatus

struct	simBusyStatus

struct	UIMGetCardStatusResp

struct	UIMGetCardStatusRespV2

struct	cardResult

struct	UIMSessionInformation

struct	setPINProtection

struct	UIMSetPinProtectionReq

struct	remainingRetries

struct	encryptedPIN1

struct	UIMPinResp

struct	UIMPinRespV2

struct	verifyUIMPIN

struct	UIMVerifyPinReq

struct	changeUIMPIN

struct	UIMChangePinReq

struct	unblockUIMPIN

struct	UIMUnblockPinReq

struct	UIMEventRegisterReqResp

struct	UIMRefreshOKReq

struct	registerRefresh

struct	UIMRefreshRegisterReq

struct	UIMRefreshCompleteReq

struct	UIMRefreshGetLastEventResp

struct	UIMRefreshGetLastEventReq

struct	UIMGetFileAttributesReq

struct	fileAttributes

struct	UIMGetFileAttributesResp

struct	depersonalizationInformation

struct	UIMDepersonalizationReq

struct	UIMDepersonalizationResp

struct	authenticationData

struct	UIMAuthenticateReq

struct	authenticateResult

struct	UIMAuthenticateResp

struct	readResult

struct	readTransparentInfo

struct	UIMReadTransparentReq

struct	UIMReadTransparentResp

struct	UIMPowerUpReq

struct	UIMSlotStatus

struct	UIMSlotsStatus

struct	UIMSlotInfo

struct	UIMSlotsInfo

struct	UIMGetSlotsStatusResp

struct	GetSlotsStatusTlv

struct	GetSlotsInfoTlv

struct	UIMGetSlotsStatusRespV2

struct	UIMSwitchSlotReq

struct	personalizationStatus

struct	UIMGetConfigurationReq

struct	UIMGetConfigurationResp

struct	UIMSetServiceStatusReq

struct	UIMGetServiceStatusReq

struct	UIMGetFDNStatus

struct	UIMGetHiddenKeyStatus

struct	UIMGetIndex

struct	UIMGetServiceStatusResp

struct	readRecordInfo

struct	UIMReadRecordReq

struct	cardResultInfo

struct	readResultInfo

struct	additionalReadResult

struct	indToken

struct	UIMReadRecordResp

struct	writeRecordInfo

struct	UIMWriteRecordReq

struct	UIMWriteRecordResp

struct	writeTransparentInfo

struct	UIMWriteTransparentReq

struct	UIMWriteTransparentResp

struct	eidInfo

struct	UIMGetEidReq

struct	UIMGetEidResp

struct	UIMProfileCode

struct	UIMAddProfileReq

struct	UIMDeleteProfileReq

struct	UIMNickName

struct	UIMUpdateProfileReq

struct	UIMGetSIMProfileReq

struct	getSimProfileInfo

struct	activeProfileInfo

struct	UIMGetSIMProfileResp

struct	UIMSetSIMProfileReq

struct	profileICCIDTlv

struct	profileStateTlv

struct	profileNicknameTlv

struct	profileSPNTlv

struct	profileNameTlv

struct	profileIconTypeTlv

struct	profileIconTlv

struct	profileClassTlv

struct	profilePolicyRulesTlv

struct	UIMGetProfileInfoReq

struct	UIMGetProfileInfoResp

struct	UIMeUICCMemResetReq

Macros
#define	MAX_DESCRIPTION_LENGTH 255

#define	MAX_CONTENT_LENGTH 1024

#define	MAX_NO_OF_APPLICATIONS 10

#define	MAX_NO_OF_SLOTS 5

#define	MAX_PUK_LENGTH 8

#define	MAX_PATH_LENGTH 255

#define	MAX_ICCID_LENGTH 255

#define	MAX_SLOTS_STATUS 255

#define	MAX_ATR_LENGTH 255

#define	MAX_PHY_SLOTS_INFO 255

#define	MAX_ACTIVE_PERS_FEATURES 12

Functions
ULONG	SLQSUIMReset ()

ULONG	SLQSUIMPowerDown (UIMPowerDownReq *pUIMPowerDownReq)

ULONG	SLQSUIMGetCardStatus (UIMGetCardStatusResp *pUIMGetCardStatusResp)

ULONG	SLQSUIMGetCardStatusV2 (UIMGetCardStatusRespV2 *pUIMGetCardStatusResp)

ULONG	SLQSUIMSetPinProtection (UIMSetPinProtectionReq pUIMSetPinProtectionReq, UIMPinResp pUIMSetPinProtectionResp)

ULONG	SLQSUIMVerifyPin (UIMVerifyPinReq pUIMVerifyPinReq, UIMPinResp pUIMVerifyPinResp)

ULONG	SLQSUIMChangePin (UIMChangePinReq pUIMChangePinReq, UIMPinResp pUIMChangePinResp)

ULONG	SLQSUIMUnblockPin (UIMUnblockPinReq pUIMUnblockPinReq, UIMPinResp pUIMUnblockPinResp)

ULONG	SLQSUIMUnblockPinV2 (UIMUnblockPinReq pUIMUnblockPinReq, UIMPinRespV2 pUIMUnblockPinResp)

ULONG	SLQSUIMEventRegister (UIMEventRegisterReqResp *pUIMEventRegisterReqResp)

ULONG	SLQSUIMRefreshOK (UIMRefreshOKReq *pUIMRefreshOKReq)

ULONG	SLQSUIMRefreshRegister (UIMRefreshRegisterReq *pUIMRefreshRegisterReq)

ULONG	SLQSUIMRefreshComplete (UIMRefreshCompleteReq *pUIMRefreshCompleteReq)

ULONG	SLQSUIMRefreshGetLastEvent (UIMRefreshGetLastEventReq pUIMRefreshGetLastEventReq, UIMRefreshGetLastEventResp pUIMRefreshGetLastEventResp)

ULONG	SLQSUIMGetFileAttributes (UIMGetFileAttributesReq pUIMGetFileAttributesReq, UIMGetFileAttributesResp pUIMGetFileAttributesResp)

ULONG	SLQSUIMDepersonalization (UIMDepersonalizationReq pUIMDepersonilizationReq, UIMDepersonalizationResp pUIMDepersonilizationResp)

ULONG	SLQSUIMAuthenticate (UIMAuthenticateReq pUIMAuthenticateReq, UIMAuthenticateResp pUIMAuthenticateResp)

ULONG	SLQSUIMReadTransparent (UIMReadTransparentReq pUIMReadTransparentReq, UIMReadTransparentResp pUIMReadTransparentResp)

ULONG	SLQSUIMPowerUp (UIMPowerUpReq *pUIMPowerUpReq)

ULONG	SLQSUIMGetSlotsStatus (UIMGetSlotsStatusResp *pResp)

ULONG	SLQSUIMGetSlotsStatusV2 (UIMGetSlotsStatusRespV2 *pResp)

ULONG	SLQSUIMSwitchSlot (UIMSwitchSlotReq *pReq)

ULONG	SLQSUIMGetConfiguration (UIMGetConfigurationReq pUIMGetConfigurationReq, UIMGetConfigurationResp pUIMGetConfigurationResp)

ULONG	SLQSUIMSetServiceStatus (UIMSetServiceStatusReq *pUIMSetServiceStatusReq)

ULONG	SLQSUIMGetServiceStatus (UIMGetServiceStatusReq pUIMGetServiceStatusReq, UIMGetServiceStatusResp pUIMGetServiceStatusResp)

ULONG	SLQSUIMReadRecord (UIMReadRecordReq pUIMReadRecordReq, UIMReadRecordResp pUIMReadRecordResp)

ULONG	SLQSUIMWriteRecord (UIMWriteRecordReq pUIMWriteRecordReq, UIMWriteRecordResp pUIMWriteRecordResp)

ULONG	SLQSUIMWriteTransparent (UIMWriteTransparentReq pUIMWriteTransparentReq, UIMWriteTransparentResp pUIMWriteTransparentResp)

ULONG	SLQSUIMGetEID (UIMGetEidReq pSlotID, UIMGetEidResp pResp)

ULONG	SLQSUIMAddProfile (UIMAddProfileReq *pUIMAddProfileReq)

ULONG	SLQSUIMDeleteProfile (UIMDeleteProfileReq *pUIMDeleteProfileReq)

ULONG	SLQSUIMUpdateProfile (UIMUpdateProfileReq *pUIMUpdateProfileReq)

ULONG	SLQSUIMGetSIMProfile (UIMGetSIMProfileReq pUIMGetSIMProfileReq, UIMGetSIMProfileResp pUIMGetSIMProfileResp)

ULONG	SLQSUIMSetSIMProfile (UIMSetSIMProfileReq *pUIMSetSIMProfileReq)

ULONG	SLQSUIMGetProfileInfo (UIMGetProfileInfoReq pUIMGetProfileInfoReq, UIMGetProfileInfoResp pUIMGetProfileInfoResp)

ULONG	SLQSUIMeUICCMemReset (UIMeUICCMemResetReq *pUIMeUICCMemResetReq)

Detailed Description

Uim Service API function prototypes.

Macro Definition Documentation

#define MAX_ACTIVE_PERS_FEATURES 12

#define MAX_ATR_LENGTH 255

#define MAX_CONTENT_LENGTH 1024

#define MAX_DESCRIPTION_LENGTH 255

#define MAX_ICCID_LENGTH 255

#define MAX_NO_OF_APPLICATIONS 10

#define MAX_NO_OF_SLOTS 5

#define MAX_PATH_LENGTH 255

#define MAX_PHY_SLOTS_INFO 255

#define MAX_PUK_LENGTH 8

#define MAX_SLOTS_STATUS 255

Function Documentation

ULONG SLQSUIMAddProfile ( UIMAddProfileReq * pUIMAddProfileReq )

This API downloads a new profile for eUIM card.

Parameters

pUIMAddProfileReq[IN]

Structure containing Add Profile request parameters.

See UIMAddProfileReq for more informataion.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMAuthenticate	(	UIMAuthenticateReq *	pUIMAuthenticateReq,
		UIMAuthenticateResp *	pUIMAuthenticateResp
	)

This API executes the authentication algorithm on the card.

Parameters

pUIMAuthenticateReq[IN]	See UIMAuthenticateReq for more information.
pUIMAuthenticateResp[OUT]	See UIMAuthenticateResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API executes a security command on the card that depends on
    the card type.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the read request.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMAuthenticateCallback

ULONG SLQSUIMChangePin	(	UIMChangePinReq *	pUIMChangePinReq,
		UIMPinResp *	pUIMChangePinResp
	)

This API changes the value of the specified PIN.

Parameters

pUIMChangePinReq[IN]	See UIMChangePinReq for more information.
pUIMChangePinResp[OUT]	See UIMPinResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API changes the value of the specified PIN.
    The application must pass both the new and the old values of the
    PIN to complete the operation
    The same PIN can be used by multiple sessions (i.e., the PIN is
    shared between GSM and RUIM in an ICC card).
    The PIN is automatically set for all the sessions when the API
    is executed.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMChangePinCallback.

ULONG SLQSUIMDeleteProfile ( UIMDeleteProfileReq * pUIMDeleteProfileReq )

This API deletes a profile for eUIM card.

Parameters

pUIMDeleteProfileReq[IN]

Structure containing Delete Profile request parameters.

See UIMDeleteProfileReq for more informataion.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMDepersonalization	(	UIMDepersonalizationReq *	pUIMDepersonilizationReq,
		UIMDepersonalizationResp *	pUIMDepersonilizationResp
	)

This API de-activates or unblocks the personalization on the phone.

Parameters

pUIMDepersonilizationReq[IN]	See UIMDepersonalizationReq for more information.
pUIMDepersonilizationResp[OUT]	See UIMDepersonalizationResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API deactivates or unblocks the personalization on the phone.
    Each feature can be deactivated/unblocked independently of the
    other features.

ULONG SLQSUIMeUICCMemReset ( UIMeUICCMemResetReq * pUIMeUICCMemResetReq )

This API changes the status of a service on the card.

Parameters

pUIMeUICCMemResetReq[IN]

Structure containing eUICC memory reset request parameters.

See UIMeUICCMemResetReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMEventRegister ( UIMEventRegisterReqResp * pUIMEventRegisterReqResp )

This API Registers for event notifications from the card.

Parameters

pUIMEventRegisterReqResp[IN/OUT]

See UIMEventRegisterReqResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function registers for event notifications from the card.
    The client must verify the mask in the response to determine
    which events were registered successfully. Events not supported
    correctly are not registered. The client can deregister from
    all event notifications by passing &ldquo;0x00000000&rdquo; bitmask in the
    request.

ULONG SLQSUIMGetCardStatus ( UIMGetCardStatusResp * pUIMGetCardStatusResp )

This API retrieves the current status of the card.

Parameters

pUIMGetCardStatusResp[OUT]

See UIMGetCardStatusResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function retrieves the current status of the card(activated)
    and the status of all applications available on the card.
    The function also returns support information for the hot-swap
    feature and the status of the switch used to detect a card
    removal/insertion.

    Please use \ref SLQSUIMGetSlotsStatus to retrieves active and 
    inactivate SIMs status.

ULONG SLQSUIMGetCardStatusV2 ( UIMGetCardStatusRespV2 * pUIMGetCardStatusResp )

This API retrieves the current status of the card -V2.

Parameters

pUIMGetCardStatusResp[OUT]

See UIMGetCardStatusResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function retrieves the current status of the card(activated)
    and the status of all applications available on the card.
    The function also returns support information for the hot-swap
    feature and the status of the switch used to detect a card
    removal/insertion.

    Please use \ref SLQSUIMGetSlotsStatus to retrieves active and 
    inactivate SIMs status.

ULONG SLQSUIMGetConfiguration	(	UIMGetConfigurationReq *	pUIMGetConfigurationReq,
		UIMGetConfigurationResp *	pUIMGetConfigurationResp
	)

This API Gets the modem configuration for the UIM module.

Parameters

pUIMGetConfigurationReq[IN]	See UIMGetConfigurationReq for more information.
pUIMGetConfigurationResp[OUT]	See UIMGetConfigurationResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMGetEID	(	UIMGetEidReq *	pSlotID,
		UIMGetEidResp *	pResp
	)

This API retrieves the eUICC ID for the given slot.

Parameters

pSlotID[IN]	See UIMGetEidReq for more information.
pResp[OUT]	See UIMGetEidResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMGetFileAttributes	(	UIMGetFileAttributesReq *	pUIMGetFileAttributesReq,
		UIMGetFileAttributesResp *	pUIMGetFileAttributesResp
	)

This API retrieves the file attributes for any Elementary File(EF) or Dedicated File(DF) in the card and provides access by the path.

Parameters

pUIMGetFileAttributesReq[IN]	See UIMGetFileAttributesReq for more information.
pUIMGetFileAttributesResp[OUT]	See UIMGetFileAttributesResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API retrieves the file attributes for any Elementary File(EF)
    or Dedicated File(DF) in the card and provides access by the path.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the select request.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMGetFileAttributesCallback.

ULONG SLQSUIMGetProfileInfo	(	UIMGetProfileInfoReq *	pUIMGetProfileInfoReq,
		UIMGetProfileInfoResp *	pUIMGetProfileInfoResp
	)

This API Queries the profile information from the card.

Parameters

pUIMGetProfileInfoReq[IN]	See UIMGetProfileInfoReq for more information.
pUIMGetProfileInfoResp[OUT]	See UIMGetProfileInfoResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMGetServiceStatus	(	UIMGetServiceStatusReq *	pUIMGetServiceStatusReq,
		UIMGetServiceStatusResp *	pUIMGetServiceStatusResp
	)

This API retrieves the status of a service on the card.

Parameters

pUIMGetServiceStatusReq[IN]	Structure containing Get Service Status request parameters. See UIMGetServiceStatusReq for more informtaion.
pUIMGetServiceStatusResp[OUT]	Structure containing Get Service Status response parameters. See UIMGetServiceStatusResp for more informtaion.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function retrieves the status of the services on the card.
    As a current limitation, it is possible to request only one
    service status in each request.
    The function supports only provisioning sessions.

ULONG SLQSUIMGetSIMProfile	(	UIMGetSIMProfileReq *	pUIMGetSIMProfileReq,
		UIMGetSIMProfileResp *	pUIMGetSIMProfileResp
	)

This API queries the profile information from the card.

Parameters

pUIMGetSIMProfileReq[IN]	See UIMGetSIMProfileReq for more information.
pUIMGetSIMProfileResp[OUT]	See UIMGetSIMProfileResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMGetSlotsStatus ( UIMGetSlotsStatusResp * pResp )

This API Retrieves the current of the physical and logical slots.

Parameters

pResp[OUT]

See UIMGetSlotsStatusResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMGetSlotsStatusV2 ( UIMGetSlotsStatusRespV2 * pResp )

This API Retrieves the current of the physical and logical slots.

Parameters

pResp[OUT]

See UIMGetSlotsStatusRespV2 for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMPowerDown ( UIMPowerDownReq * pUIMPowerDownReq )

This API powers down the SIM card.

Parameters

pUIMPowerDownReq[IN]

See UIMPowerDownReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function powers down the card.
    This is usually performed when the phone is switched off or when
    it is set to Airplane mode.

ULONG SLQSUIMPowerUp ( UIMPowerUpReq * pUIMPowerUpReq )

This API powers up the SIM card.

Parameters

pUIMPowerUpReq[IN]

See UIMPowerUpReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function powers up the card.
    This is usually performed when the phone is switched off or when
    it is set to Airplane mode.

ULONG SLQSUIMReadRecord	(	UIMReadRecordReq *	pUIMReadRecordReq,
		UIMReadRecordResp *	pUIMReadRecordResp
	)

This API executes the Read Record algorithm on the card.

Parameters

pUIMReadRecordReq[IN]	See UIMReadRecordReq for more information.
pUIMReadRecordResp[OUT]	See UIMReadRecordResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API provides read access to a specific record in a linear
    fixed or cyclic file in the card and provides access by the path.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the read request.
    The client can pass a token in the request to receive the result
    in a subsequent QMI_UIM_READ_RECORD_IND indication.

ULONG SLQSUIMReadTransparent	(	UIMReadTransparentReq *	pUIMReadTransparentReq,
		UIMReadTransparentResp *	pUIMReadTransparentResp
	)

This API executes the Read Transparent algorithm on the card.

Parameters

pUIMReadTransparentReq[IN]	See UIMReadTransparentReq for more information.
pUIMReadTransparentResp[OUT]	See UIMReadTransparentResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API Provides read access to any transparent file in the
    card and provides access by the path.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the read request.
    The client can pass a token in the request to receive the result
    in a subsequent QMI_UIM_READ_TRANSPARENT_IND indication.

ULONG SLQSUIMRefreshComplete ( UIMRefreshCompleteReq * pUIMRefreshCompleteReq )

This API invoked when the client has finished the Refresh procedure.

Parameters

pUIMRefreshCompleteReq[IN]

See UIMRefreshCompleteReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function is invoked when the client has finished the Refresh
    procedure (has reread all the cached files) and communicates this
    to the modem. This function enables the terminal response to be
    sent to the card

ULONG SLQSUIMRefreshGetLastEvent	(	UIMRefreshGetLastEventReq *	pUIMRefreshGetLastEventReq,
		UIMRefreshGetLastEventResp *	pUIMRefreshGetLastEventResp
	)

This API provides the ability to retrieve the last refresh event.

Parameters

pUIMRefreshGetLastEventReq[IN]	See UIMRefreshGetLastEventReq for more information.
pUIMRefreshGetLastEventResp[OUT]	See UIMRefreshGetLastEventResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function provides the ability to retrieve the last refresh
    event. The event information is usually passed in as an indication
    from the QMI to the application and is saved by the application at
    that time. If the event information is not saved, the client can
    retrieve the last refresh event.
    Details regarding the Refresh procedure (i.e., the stages and
    actions that an application must complete) are described in
    document: 80-VM566-1(NAA Refresh High Level Guide )

ULONG SLQSUIMRefreshOK ( UIMRefreshOKReq * pUIMRefreshOKReq )

This API Enables the client to indicate whether it is OK to start the Refresh procedure.

Parameters

pUIMRefreshOKReq[IN]

Consist of parameters for SLQSUIMRefreshOK. Please see /ref UIMRefreshOKReq for details.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function enables the client to indicate whether it is OK to
    start the Refresh procedure. This command is used only after a
    refresh event is received, which indicates the need to vote.

ULONG SLQSUIMRefreshRegister ( UIMRefreshRegisterReq * pUIMRefreshRegisterReq )

This API Registers for file change notifications triggered by the card.

Parameters

pUIMRefreshRegisterReq[IN]

See UIMRefreshRegisterReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function registers for file change notifications triggered
    by the card. The client can specify a list of files. The client
    is notified only when one of the files is modified by the Refresh
    procedure. This function can be invoked multiple times for each
    session type. If the function is invoked twice with the same session
    type, the new values overwrite the previous values. The client can
    also use this function to stop receiving indications of the refresh.
    This API should be invoked prior to the invocation of the
    SLQSUIMSetRefreshCallBack for the events to be registered.

ULONG SLQSUIMReset ( )

This API resets the issuing control points state kept by the service.

Parameters

None

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    The list of events to which the client is registered is emptied.
    The client must register again using the SLQSUIMEventReg API
    to start receiving the events again. This would mean that the
    callback registrations would be reset after this API.

ULONG SLQSUIMSetPinProtection	(	UIMSetPinProtectionReq *	pUIMSetPinProtectionReq,
		UIMPinResp *	pUIMSetPinProtectionResp
	)

This API enables or disables the protection of the UIM contents by a specific PIN.

Parameters

pUIMSetPinProtectionReq[IN]	See UIMSetPinProtectionReq for more information.
pUIMSetPinProtectionResp[OUT]	See UIMPinResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API enables or disables the protection of UIM contents by a
    specific PIN.
    The same PIN can be used by multiple sessions (i.e., the PIN is
    shared between GSM and RUIM in an ICC card).
    The PIN is automatically set for all the sessions when the API
    is executed.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMSetPinProtectionCallback indication.

ULONG SLQSUIMSetServiceStatus ( UIMSetServiceStatusReq * pUIMSetServiceStatusReq )

This API changes the status of a service on the card.

Parameters

pUIMSetServiceStatusReq[IN]

Structure containing Set Service Status request parameters.

See UIMSetServiceStatusReq for more informataion.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This function sets the status of a service on the card.
    It currently supports only the FDN status, but can be extended
    in the future for other services.
    The function supports only provisioning sessions.

ULONG SLQSUIMSetSIMProfile ( UIMSetSIMProfileReq * pUIMSetSIMProfileReq )

This API changes the status of a service on the card.

Parameters

pUIMSetSIMProfileReq[IN]

Structure containing Set Service Status request parameters.

See UIMSetSIMProfileReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMSwitchSlot ( UIMSwitchSlotReq * pReq )

This API Switches the binding between a logical slot and a physical slot.

Parameters

pReq[IN]

See UIMSwitchSlotReq for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    Please wait at least one second before this API call again.

ULONG SLQSUIMUnblockPin	(	UIMUnblockPinReq *	pUIMUnblockPinReq,
		UIMPinResp *	pUIMUnblockPinResp
	)

This API unblocks a blocked PIN using the PUK code.

Parameters

pUIMUnblockPinReq[IN]	See UIMUnblockPinReq for more information.
pUIMUnblockPinResp[OUT]	See UIMPinResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API unblocks a blocked PIN using the PUK code.
    The client must pass PUK1 to unblock PIN1 or PUK2 to unblock PIN2.
    The same PIN can be used by multiple sessions (i.e., the PIN is
    shared between GSM and RUIM in an ICC card).
    The PIN is automatically set for all the sessions when the API
    is executed.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMUnblockPinCallback.

ULONG SLQSUIMUnblockPinV2	(	UIMUnblockPinReq *	pUIMUnblockPinReq,
		UIMPinRespV2 *	pUIMUnblockPinResp
	)

This API unblocks a blocked PIN using the PUK code -V2.

Parameters

pUIMUnblockPinReq[IN]	See UIMUnblockPinReq for more information.
pUIMUnblockPinResp[OUT]	See UIMPinResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API unblocks a blocked PIN using the PUK code.
    The client must pass PUK1 to unblock PIN1 or PUK2 to unblock PIN2.
    The same PIN can be used by multiple sessions (i.e., the PIN is
    shared between GSM and RUIM in an ICC card).
    The PIN is automatically set for all the sessions when the API
    is executed.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMUnblockPinCallback.

ULONG SLQSUIMUpdateProfile ( UIMUpdateProfileReq * pUIMUpdateProfileReq )

This API updates a profile nick name for eUIM card.

Parameters

pUIMUpdateProfileReq[IN]

Structure containing Update Profile request parameters.

See UIMUpdateProfileReq for more informataion.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note: Timeout: 30 Secs

ULONG SLQSUIMVerifyPin	(	UIMVerifyPinReq *	pUIMVerifyPinReq,
		UIMPinResp *	pUIMVerifyPinResp
	)

This API verifies the PIN before the card content is accessed.

Parameters

pUIMVerifyPinReq[IN]	See UIMVerifyPinReq for more information.
pUIMVerifyPinResp[OUT]	See UIMPinResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API verifies the PIN before the card content is accessed.
    The same PIN can be used by multiple sessions (i.e., the PIN is
    shared between GSM and RUIM in an ICC card).
    The PIN is automatically set for all the sessions when the API
    is executed.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMVerifyPinCallback.

ULONG SLQSUIMWriteRecord	(	UIMWriteRecordReq *	pUIMWriteRecordReq,
		UIMWriteRecordResp *	pUIMWriteRecordResp
	)

This API executes the Write Record algorithm on the card.

Parameters

pUIMWriteRecordReq[IN]	See UIMWriteRecordReq for more information.
pUIMWriteRecordResp[OUT]	See UIMWriteRecordResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API provides write access to a specific record in a linear
    fixed or cyclic file in the card and provides access by the path.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the write request.
    The client can pass a token in the request to receive the result
    in a subsequent QMI_UIM_WRITE_RECORD_IND indication.

ULONG SLQSUIMWriteTransparent	(	UIMWriteTransparentReq *	pUIMWriteTransparentReq,
		UIMWriteTransparentResp *	pUIMWriteTransparentResp
	)

This API executes the Write Transparent algorithm on the card.

Parameters

pUIMWriteTransparentReq[IN]	See UIMWriteTransparentReq for more information.
pUIMWriteTransparentResp[OUT]	See UIMWriteTransparentResp for more information.

Returns: eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise

See Also: See qmerrno.h for eQCWWAN_xxx error values

Note

Timeout: 30 Secs

    This API provides access to any transparent file in the card and
    provides access by the path.
    The response contains the status code received from the card
    (SW1 and SW2) when the card responded to the write request.
    The client can pass a token in the request to receive the result
    in a subsequent SLQSUIMWriteTransparentCallback.

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

Function Documentation